Skip to content

contracts: bootstrap sourceos-shell artifact, PDF, search, and comment schemas#33

Merged
mdheller merged 11 commits intomainfrom
feat/sourceos-shell-contracts-bootstrap
Apr 18, 2026
Merged

contracts: bootstrap sourceos-shell artifact, PDF, search, and comment schemas#33
mdheller merged 11 commits intomainfrom
feat/sourceos-shell-contracts-bootstrap

Conversation

@mdheller
Copy link
Copy Markdown
Contributor

Summary

Bootstrap the first sourceos-shell contract cut in sourceos-spec.

This PR adds:

  • ADR documenting the repo boundary
  • initial schemas for shell/document/provenance/search/comment flows
  • conforming examples for the initial object set

Added files

ADR

  • docs/adr/0001-sourceos-shell-boundary.md

Schemas

  • schemas/ArtifactManifest.json
  • schemas/SignedArtifact.json
  • schemas/PdfValidationReport.json
  • schemas/SearchRouteDecision.json
  • schemas/CommentSignal.json

Examples

  • examples/artifact-manifest.json
  • examples/signed-artifact.json
  • examples/pdf-validation-report.json
  • examples/search-route-decision.json
  • examples/comment-signal.json

Why

This establishes the first canonical object shapes needed by the planned sourceos-shell product/runtime repo, while keeping Linux realization and launcher bridge work out of the contract repo.

Follow-on

Subsequent PRs can add:

  • AnnotationExport
  • RunReport
  • NoetherDiagnostic
  • PublishDecision
  • MirrorReceipt
  • OpenAPI/AsyncAPI additions for these surfaces

@mdheller mdheller marked this pull request as ready for review April 18, 2026 02:38
@mdheller mdheller merged commit 3c77ff1 into main Apr 18, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant